home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / misc / amag / AM94122.lha / Monitor-Tuning / MPatch_MonitorInfo / MonitorInfo.DOC < prev    next >
Encoding:
Text File  |  1994-08-25  |  5.3 KB  |  131 lines
  1. MONITORINFO - The Monitor Peek Utility, V37.8
  2. =============================================
  3.  
  4. MonitorInfo is a small utility that allows to view some important properties
  5. of an AMIGA monitor specification as introduced with Release 2 of the Amiga
  6. Operating System.
  7.  
  8. MonitorInfo can only be used from CLI or Shell. Its usage is quite simple:
  9. just enter
  10.  
  11.    MONITORINFO <monitor-name> [<monitor-name>] [RAW]
  12.  
  13. where <monitor-name> is the name of the monitor whose properties you wish to
  14. inspect. The ".monitor" extension may be omittet, but upper/lowercase are
  15. important (not my fault, but the FindName() library function doesn't support
  16. case independent search 8-[.)
  17. Until Release 2.1 (V38), all the monitor names are lower case. The new modes
  18. introduced with Release 3.0 (V39), however, are mixed case. You must type
  19. "DoublePAL.monitor" and "DoubleNTSC.monitor" in order that these names be
  20. recognized.
  21.  
  22. If you don't know how to spell the monitor's name, or have no idea of what
  23. monitors are installed in your system, enter MONITORINFO LIST (new V37.3
  24. feature), to get a list of all monitors currently installed. Type the monitor
  25. name exactly as it is written in this list.
  26.  
  27. If the monitor you specified could be found in the database, a lot of
  28. information will pour over your screen, starting with perhaps the most
  29. interesting values: the horizontal and vertical scan rates. They might look
  30. a bit odd, but they are accurate. Their values are calculated directly from
  31. the custom chip's DMA timebase, rather than using a rough average.
  32. The "lowres pixel aspect ratio" is the width to height ratio of a lowres,
  33. non-interlace pixel on the given monitor. E.g. a value of 2.00 means that a
  34. pixel is twice as wide as high, and a value of 0.75 means that a pixel has
  35. an aspect ration of 3:4 etc.
  36.  
  37. If your monitor is not one of the video modes (PAL or NTSC), the timings of
  38. the horizontal and vertical synchronisation and blanking intervals will also
  39. be displayed. The "delay" value after the horizontal and vertical sync
  40. interval values is the "offset" of the sync pulse from the beginning of the
  41. corresponding blanking interval. If your entered the keyword "RAW" on the
  42. command line, the hardware register's values are displayed instead of the
  43. signal intervals in microseconds (µs).
  44.  
  45. After that, the signal properties of this monitor are displayed. This value is
  46. exactly what is written into the BeamCon0 register when this monitor is used.
  47. The following flags are defined under both ECS and AA:
  48.  
  49. HSYNCTRUE - vertical sync signal has positive polarity ("true" logical level)
  50.  
  51. VSYNCTRUE - horizontal sync signal has positive polarity ("true" log. level)
  52.  
  53. CSYNCTRUE - composite sync signal has positive polarity
  54.  
  55. CSBLANK - composite blank output to CSY pin (ECS), unused (AA)
  56.  
  57. VARCSYNC - variable composite sync enabled. By default, the graphics chip
  58.    uses fixed values for PAL or NTSC modes
  59.  
  60. DISPLAYPAL - if set, tells graphics chip to use PAL color encoding
  61.  
  62. DISPLAYDUAL - uses UHRES pointers and standard pointers
  63.  
  64. VARBEAM - enables custom scan rates other than 15 kHz
  65.  
  66. VARHSYNC - enables custom horizontal sync settings
  67.  
  68. VARVSYNC - enables custom vertical sync settings
  69.  
  70. CSCBLANKEN - redirect composite sync to HSY pin, and composite blank to
  71.    VSY pin. (both sync and blank still come out of the CSY pin however)
  72.  
  73. VARVBLANK - enables custom vertical blanking settings
  74.  
  75. LPENDIS - disable lightpen latched values in VPOSR, VHPOSR and HHPOSR, and
  76.    read actual beam counter value even if lightpen is triggered (AA only)
  77.  
  78. HARDDIS - disable hardwire display window limits. This bit is automatically
  79.    set when VARBEAM is enabled (set) (AA only)
  80.  
  81. (For more information about these values, I recommend the AGA Guide document
  82. found on the FreshFish CDROM, December 1993 Edition, and on the AmiNet III
  83. CDROM (July 1994))
  84.  
  85. NOTE: It should be possible to inspect non-native (RTG) modes as well, if 
  86. they link into the GfxBase monitor list, as the PICASSO and EGS/Spectrum
  87. cards do. However, I do not know whether the values returned will be of any
  88. use. Some, like the sweep rates, might be reasonable; others, like
  89. the signal properties, might not be. There is no information about how the
  90. RTG (Re-Targetable Graphics) will actually be implemented. However, if anybody
  91. sends me information about his graphics board, I might well enhance this
  92. little utility.
  93.  
  94. LEGAL STUFF:
  95. ------------
  96.  
  97. This software is provided "as-is". No warranties are made. All use is at
  98. the user's own risk. The author assumes no liability for any incidential or
  99. consequential damage to your equipment, physical or mental health resulting
  100. from the use of this product.
  101.  
  102. This software is freely distributable as long as all the files are left
  103. intact and no more than a reasonable fee to cover copying, media and mailing
  104. costs is charged.
  105.  
  106. Inclusion of the software on PD Collections and magazine coverdisks is 
  107. expressly encouraged. For the latter, I would like to receive a free copy
  108. of the magazine (including disks).
  109.  
  110.  
  111. If you have any bug reports, suggestions for improvements etc., write to
  112.  
  113.    Gregor S. M. Kuhlmann
  114.    Friedhofsallee 4/5
  115.    A-2451 Hof am Leithaberge
  116.    AUSTRIA
  117.    EUROPE
  118.  
  119. or to
  120.  
  121.    Gregor S. M. Kuhlmann
  122.    c/o Digital Sound & Vision
  123.    Kauergasse 10/2
  124.    A-1150 Wien
  125.    AUSTRIA
  126.    EUROPE
  127.  
  128. (expect longer reply times when writing to the second address...)
  129.  
  130. (sorry no email yet, but I'm working on it ...)
  131.